home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 3: Developer Tools / Linux Cubed Series 3 - Developer Tools.iso / utils / console / svgatext.3 / svgatext / SVGATextMode-1.3 / contrib / README
Encoding:
Text File  |  1996-04-20  |  5.7 KB  |  153 lines

  1.  
  2. This directory contains several utilities not directly linked to
  3. SVGATextMode, but in one way or another useful to SVGATextMode users.
  4.  
  5. * All binaries in this directory are in a.out format! If you have an ELF
  6. * system, you'll have to recompile them.
  7.  
  8.  
  9. Ultra2Linux:
  10.  
  11.     A utility to convert UltraVision fonts to Linux fonts.  Ultravision
  12.         is a commercial (!) DOS program with similar functionality as
  13.         SVGATextMode. Those of you who bought a copy of Ultravision should
  14.         be able to use this tool to convert some fonts from Ultravision to
  15.         the linux format used by "setfont" (also in this directory).
  16.         UltraVision fonts are attractive because they also exist in a
  17.         20-pixel high version, which is unavailable in the standard Linux
  18.         fonts.
  19.         Author: Kenneth Albanowski
  20.  
  21.  
  22. setfont:
  23.  
  24.     A small tool to set the text mode font. It was taken from the
  25.         "keytbls" package included in the Slackware distribution. It can
  26.         also be found in the "kbd-0.87.tar.gz" package (or any newer
  27.         version) available on many FTP sites that carry Linux software.
  28.         Authors: Eugene Crosser & Andries Brouwer
  29.         
  30.         Also note the "8x8plus" font. It is a normal PC font (instead of
  31.         Cyrillic). It will load as an 8x32 font but will work for 8x8 to
  32.         8x14. The letters will all fit in an 8x8 cell, but the line drawing
  33.         chars are a full 8x32. (contributed by Albert Cahalan
  34.         <albert@ccs.neu.edu>).
  35.         
  36.         It would be a nice thing if ALL fonts used "extended" (full 32-pixel
  37.         high) line drawing chars, so they can be used for bigger font sizes
  38.         as well, without compromising boxes and lines.
  39.  
  40.  
  41.  
  42. vgaset:
  43.  
  44.     Another hacking tool. It can be used to fine-tune text modes (or
  45.         X-Windows graphics modes). It allows you to move the screen
  46.         position, set sync widths, and many more. See the documentation in
  47.     the vgaset directory for more information.
  48.     Author: Greg Lehey (grog@lemis.de)
  49.  
  50.  
  51. svgalib:
  52.  
  53.         Some sample applications of how the tools from SVGATextMode can be
  54.         used in svgalib, and for other applications also. 
  55.         
  56.         'et4000.grab_svgalib_mode' is a script to grab an svgalib-compatible
  57.         mode from your vga card. It outputs a block of text you can put into
  58.         the libvga.config file.
  59.         
  60.         'libvga.et4000-320x200x16M' contains a libvga.config entry for an
  61.         320x200 mode with 16M colors, which is normally unavailable for
  62.         those cards (they have 640x400 at 16M colors, but that makes those
  63.         MPEG files as big as stamps.)
  64.         
  65.         There is also an s3.grab_svgalib_mode script, which does the same
  66.         for S3 as the previous one for ET4000. I didn't need this for
  67.         svgalib, but both scripts can be very usefull to determine what
  68.         register in the chipset is responsible for a problem. Comparing
  69.         register dumps for a "good" and a "bad" case. We used the ET4000
  70.         script to pin down a problem in X (mouse cursor garbage on PCI
  71.         cards)
  72.  
  73.  
  74.  
  75. loadfont:
  76.  
  77.        An alternative to the "setfont" program from svgalib. Written by
  78.        Albert Cahalan <albert@ccs.neu.edu>.
  79.        
  80.        It understands more font files than setfont, and it can extract fonts
  81.        to raw files. It still spits out weird/extra messages sometimes.
  82.  
  83.  
  84. probe_clocks:
  85.  
  86.        A small and rudimentary script that probes for the available clocks,
  87.        like the XFREE probe does.
  88.         
  89.  
  90. scripts: 
  91.  
  92.        This directory contains some useful scripts for SVGATextMode:
  93.        
  94.        - rc.font can be put in /etc/rc.d, and will change the text mode to
  95.          100x37 chars at boot time.
  96.  
  97.        - STMmenu is a script that shows a dialog box with all allowed text
  98.          modes in it - supposing your TextConfig file is configured
  99.          correctly.
  100.        
  101.        - STM_reset is an example script of a reset program, which can be
  102.          executed automatically after SVGATextMode has finished. Anything
  103.          you want to get done when changing text modes can be put in here
  104.          (like restarting some screen-size dependent programs).
  105.          
  106.        - resize_patch is a kernel patch to make the SIGWINCH work for e.g. gpm.
  107.        
  108.        - cleanup_TextConfig formats the mode lines in the TextConfig file so
  109.          they all use the same spcing (easy for further grepping/cutting/...)
  110.  
  111.  
  112. DOS
  113.  
  114.        The DOS directory contains (what else!) tools which could be useful
  115.        to configure both SVGATextMode and XFREE86, using the modes known by DOS.
  116.        
  117.        - a DOS port of SVGATextMode: stm.exe
  118.        
  119.        - a free DMPI environment, CWSDPMI, needed to run both grabmode.exe
  120.          and stm.exe.
  121.        
  122.        - grabmode.exe is, just like the Linux version, a mode grabber that
  123.          reports a mode line comatible with SVGATextMode and XFREE.
  124.          
  125.        - scanmode.exe scans all DOS (and VESA, when available) text and
  126.          graphics modes, and outputs two files (tconfig and xconfig)
  127.          containing resp. config lines for SVGATextMode and XFREE86.
  128.          
  129.        - grabwin.exe is an MSWindows mode grabber. This is a stripped
  130.          version of the SVGATextMode-1.1 grabmode, compiled by Harald Koenig
  131.  
  132.  
  133. changefont
  134.  
  135.     Two small quick-and-dirty programs to make changes to a font - or
  136.         create a new one if you're VERY courageous). Far from user-friendly,
  137.         but they work.
  138.  
  139.  
  140. setcolor
  141.  
  142.         A replacement for the setpalette program included in SVGATextMode,
  143.         which will not work with newer kernels (1.3.x or above) anymore
  144.         because they reset the VGA palette on every VT-switch. This program
  145.         changes the palette in the kernel, so THAT one gets restored each
  146.         time.
  147.         
  148. consoletools
  149.  
  150.     contains some useful tools for handling consoles, grabbing text,
  151.     etc. See the README there.
  152.  
  153.